home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / lib / perl5 / Glib / Signal.pod < prev    next >
Encoding:
Text File  |  2009-04-29  |  1.4 KB  |  80 lines
  1. =head1 NAME
  2.  
  3. Glib::Signal -  Object customization and general purpose notification
  4.  
  5. =cut
  6.  
  7. =for object Glib::Signal Object customization and general purpose notification
  8.  
  9. =cut
  10.  
  11.  
  12.  
  13.  
  14. =head1 METHODS
  15.  
  16. =head2 integer = Glib-E<gt>B<install_exception_handler> ($func, $data=undef)
  17.  
  18. =over
  19.  
  20. =item * $func (subroutine) 
  21.  
  22. =item * $data (scalar) 
  23.  
  24. =back
  25.  
  26.  
  27. Install a subroutine to be executed when a signal emission traps an exception
  28. (a croak or die).  I<$func> should return boolean (true if the handler should
  29. remain installed) and expect to receive a single scalar.  This scalar will be a
  30. private copy of $@ which the handler can mangle to its heart's content.
  31.  
  32. Returns an identifier that may be used with C<remove_exception_handler>.
  33.  
  34. See C<gperl_install_exception_handler()> in L<Glib::xsapi>.
  35.  
  36.  
  37. =head2 Glib-E<gt>B<remove_exception_handler> ($tag)
  38.  
  39. =over
  40.  
  41. =item * $tag (integer) 
  42.  
  43. =back
  44.  
  45.  
  46. Remove the exception handler identified by I<$tag>, as returned by
  47. C<install_exception_handler>.  If I<$tag> cannot be found, this
  48. does nothing.
  49.  
  50. WARNING:  Do not call this function from within an exception handler.
  51. If you want to remove your handler during its execution just have it
  52. return false.
  53.  
  54. See C<gperl_remove_exception_handler()> in L<Glib::xsapi>.
  55.  
  56.  
  57.  
  58.  
  59. =cut
  60.  
  61.  
  62. =head1 SEE ALSO
  63.  
  64. L<Glib>
  65.  
  66.  
  67. =cut
  68.  
  69.  
  70. =head1 COPYRIGHT
  71.  
  72. Copyright (C) 2003-2009 by the gtk2-perl team.
  73.  
  74. This software is licensed under the LGPL.  See L<Glib> for a full notice.
  75.  
  76.  
  77.  
  78. =cut
  79.  
  80.